home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / ragtag_3.arc / RAGTAG.DOC < prev    next >
Text File  |  1990-04-12  |  11KB  |  227 lines
  1. RagTag 0.03
  2.  
  3. Telix script to add taglines to messages entered online, using the John 
  4. Hancock tagline program, version 2, by Dan Moore
  5.  
  6. Author: Maurice Crouse
  7.  
  8.  
  9. WHAT'S NEW
  10.  
  11. RagTag 0.03 uses John Hancock version 2, which is much more versatile 
  12. than version 1.  And now you don't have to have a copy of JH in your 
  13. Telix directory.  If you're already using version 2 in a directory with 
  14. your DeLuxe or EZ reader, you can direct RagTag to look for it in that 
  15. directory by an entry in a configuration file.
  16.  
  17.  
  18. PURPOSE
  19.  
  20. RagTag is a Telix script written for those persons who wish to use Dan 
  21. Moore's John Hancock program, version 2, to add taglines to messages 
  22. entered online.  Why would anyone want to do this?  I don't know.  Why 
  23. DO you want to do it?
  24.  
  25. Presumably you want to give the impression that you're using an offline 
  26. reader when you're not in fact doing it.  Frankly, it would be a lot 
  27. simpler and faster if you just typed in a fake reader name and a 
  28. tagline, but if you want to go to the trouble of using RagTag to do 
  29. it, you're certainly welcome.
  30.  
  31. For those of you who were hoping this script would work with other 
  32. communications programs such as Qmodem, ProComm, and Boyan, I'm sorry, 
  33. but I barely understand how to write in the Telix script language, and 
  34. anything more complicated than a simple log-on script in one of the 
  35. other script languages is beyond my ability.  If you are a master of one 
  36. of them, feel free to adapt the ideas here to your script language.
  37.  
  38.  
  39. CONTRIBUTION
  40.  
  41. No, I'm not asking for a contribution; I'm making one.
  42.  
  43. RagTag is hereby contributed to the public domain, if the public domain
  44. will have it.  It is nothing that you as a competent SALT programmer
  45. could not have written for yourself if you had put your mind to it for a 
  46. couple of hours, as I did, so I see no point in asking you to pay for 
  47. it.  You probably wouldn't pay for it even if I asked you, so there's 
  48. no point in making you feel guilty either.
  49.  
  50. You may make any changes or modifications to RagTag that you please.  
  51. To save you the effort of decompiling, disassembling, or reverse- 
  52. engineering it, the .SLT file is included along with the .SLC file.  If 
  53. you know anything at all about Telix and SALT, you can create your own 
  54. version of RagTag, even to the point of changing the logo that it 
  55. sends with the tagline.
  56.  
  57.  
  58. LIMITED WARRANTY
  59.  
  60. I make no warranty of any kind, either expressed, implied, or inferred.  
  61. The program isn't guaranteed to do anything.  It may not even work for 
  62. you; if it does, it may not work the way you want it to work.  It works 
  63. on my machine and the way I want it to work, which is more than I can 
  64. say for some people's programs.  If RagTag is not to your liking, 
  65. rewrite it or throw it away.
  66.  
  67.  
  68. LICENSE TO COPY
  69.  
  70. You are granted a license to copy RagTag for others subject to the 
  71. following limitation:
  72.  
  73. You must give the others fair warning that the software is probably 
  74. useless and that it will not be supported.
  75.  
  76. Operators of electronic bulletin board systems (sysops) may post 
  77. RagTag for downloading by their users, or they may trash it as soon as 
  78. they can get the opportunity.
  79.  
  80.  
  81. RagTag SETUP
  82.  
  83. Versions of RagTag earlier than 0.03 required that version 1 of the John 
  84. Hancock programs written by Dan Moore be used.  Why?  Because Dan wrote 
  85. version 2 in such a sneaky way that there was no way to tell what the 
  86. .REP file would be named.  Without my script knowing the name it was 
  87. just stumbling in the dark with a 1 in 26 chance of getting it right.  I 
  88. thought it better to have a program that worked 100% of the time than 
  89. just 3.85% of the time.  Finally, by an ingenious programming trick, I 
  90. was able to get RagTag 0.03 to work with version 2 of John Hancock.  
  91. (Check the .SLT file to see what the trick is.)  Well, I did get a 
  92. little bit of help from an expert programmer with that one, but I had 
  93. thought of the idea before he suggested it.  Frankly, I had thought it 
  94. wouldn't work and was amazed when it did.  Now you no longer have to 
  95. keep both versions of JH around; you can use JH2 with your DeLuxe or EZ 
  96. reader *and* with RagTag.
  97.  
  98. Using an ASCII editor or the DOS command COPY CON RAGTAG.CNF, create and 
  99. save in the Telix directory (the one with TELIX.EXE in it) a file named 
  100. RAGTAG.CNF which will contain exactly two lines.  On the first line, put 
  101. the full path to the directory in which JH.EXE, JH.CFG, and your .TAG 
  102. file(s) can be located.  On the second line, put the full path to the 
  103. directory in which TELIX.EXE is located.  My RAGTAG.CNF reads:
  104.  
  105. c:\qmail
  106. c:\telix
  107.  
  108. and if your directory structure is the same, you may simply copy into 
  109. your Telix directory the RAGTAG.CNF file which is included with 
  110. RAGTAG.ZIP.
  111.  
  112. Copy JH.EXE and JH.CFG to your favorite directory, the one you have 
  113. identified in line 1 of RAGTAG.CNF.  You must also copy at least JH.TAG 
  114. to that directory.  This is an ordinary ASCII file of taglines which you 
  115. may create for yourself.  Or, if you're like me or Bud Schrimsher, you 
  116. may steal taglines that others have written.  (The first time JH runs, 
  117. it looks for JH.TAG.  If you have other .TAG files you may copy them to 
  118. the directory also, and you may switch from one to another using the 
  119. directions in the JH documentation.)
  120.  
  121. Copy RAGTAG.SLC to your Telix directory (the one with TELIX.EXE in it).  
  122. Actually you could put it in the same directory as your other scripts, 
  123. as long as you have defined your scripts directory within Telix.  But 
  124. Telix looks in its own directory before it looks there.  No matter where 
  125. you put RAGTAG.SLC, be absolutely certain that you place RAGTAG.CNF in 
  126. the Telix directory (the one with TELIX.EXE in it).  If you don't, 
  127. RagTag won't be able to find the configuration file, and you'll probably 
  128. blame me if RagTag bombs out.  (As a favor to you, if RagTag can't find 
  129. the configuration file it will look in the Telix directory to see if JH 
  130. could possibly be there.  If so, you will probably get a tagline anyway; 
  131. if not, sorry, but RagTag can't make up taglines out of thin air.)
  132.  
  133. Execute the Telix program.  While in Telix, press <Alt><K> to bring up 
  134. the keys menu, choose "Regular", then "Display" and look for a 
  135. convenient empty function key.  When you find one, choose "Edit" and 
  136. press the function key.  When asked for what to set up on the function 
  137. key, type @RAGTAG and press <Return>.  Press <S> to save, and save the 
  138. configuration to the desired filename (probably it will be TELIX.KEY).  
  139. Press <X> to exit back to the terminal screen.
  140.  
  141.  
  142. RagTag USAGE
  143.  
  144. When you have finished writing the last word of your message online, 
  145. press <Return> to get to a new line.  (Don't press <Return> more than 
  146. once, however, because on many systems, especially PCBoard, two <Return> 
  147. characters in a row will throw you out of the editing mode.)
  148.  
  149. Press the function key to which you have assigned the call to RagTag.  
  150. (If you do not want to waste a function key definition on RagTag, you 
  151. may call it by pressing <Alt><G> to open up the Scripts window and 
  152. entering TAGTAG as the script name.)
  153.  
  154. Choose the tagline using the instructions in the JH documentation.  I 
  155. could tell you how to do this, but if you don't already know how, you 
  156. don't have any business using RagTag yet.  You've got to learn how to 
  157. crawl before you can walk.
  158.  
  159.  
  160. RagTag AUTOSAVE
  161.  
  162. There isn't any.  The procedure for saving varies so much from one 
  163. board's software to another that it's impossible to write an autosave 
  164. routine that will work for all of them.  It's up to you to save your own 
  165. messages in the way the board's software requires.
  166.  
  167.  
  168. RagTag REGISTRATION
  169.  
  170. There isn't any.  Since you're using Telix and John Hancock, be sure to 
  171. register them with Colin Sampealeanu and Dan Moore, respectively.
  172.  
  173.  
  174. RagTag SUPPORT
  175.  
  176. There isn't any.  If you should ask me anything about RagTag, I will 
  177. probably deny having written it.  You've heard of user-supported 
  178. software?  Well, this is it.  You're the user, you support it.
  179.  
  180.  
  181. BONUS SCRIPT: SHOWNAME
  182.  
  183. Some software authors will send you a bonus program or a bonus pack of 
  184. programs when you register their software.  Since I don't ask you to 
  185. register RagTag, I'll include a simple but very useful bonus script 
  186. along with RagTag.
  187.  
  188. Have you ever had that sinking feeling when you realized, all of a 
  189. sudden, that you had no idea what BBS you were connected to?  Perhaps 
  190. you use a dialing queue and a log-on script to handle things for you 
  191. automatically.  All PCBoards look very much alike; all Opus boards look 
  192. very much alike.  Or maybe your memory is just beginning to go.  For 
  193. whatever reason, if you can't puzzle out what board's screen is staring 
  194. you in the face, Telix is no great help because it doesn't display the 
  195. board's name on the status line.  ShowName to the rescue!
  196.  
  197. Copy SHOWNAME.SLC to your Telix directory or your Telix script 
  198. directory.  Using the directions above in RagTag SETUP as a guide, 
  199. configure a function key (a different one, naturally) to call the 
  200. ShowName script.  When you reach the point where you are asked what the 
  201. key is supposed to send, type @SHOWNAME instead of @RAGTAG.  After you 
  202. have properly saved the key definition file, you may find out at any 
  203. time the name of the board with which you're connected.  Just tap the 
  204. function key.  A little window will open up and display the name of the 
  205. board.  After about a second the window will vanish, restoring the 
  206. previous screen.  The board name will be displayed exactly as you have 
  207. entered it in your Telix dialing directory.  You *do* use a dialing 
  208. directory, don't you?  If not, the window will be blank, because 
  209. ShowName depends on reading the Telix system variable _entry_name, which 
  210. in turn depends on reading the name portion of the directory entry.
  211.  
  212.  
  213. RagTag ACKNOWLEDGEMENTS
  214.  
  215. I'd like to say to Colin Sampaleanu, Mark (Sparky) Herring, and Dan 
  216. Moore that RagTag would probably not have been possible without them.  
  217. But that's not correct.  Without them, it's for darn certain that RagTag 
  218. wouldn't have been possible.  Without Colin's Telix program, there would 
  219. have been no SALT scripts; without Sparky's Qmail system no one would 
  220. have known what taglines were; and without Dan's John Hancock program 
  221. RagTag wouldn't have had a clue as to how to put a tagline on the 
  222. message.  And without Dan's documentation as a model and an inspiration, 
  223. I wouldn't have learned how to write documentation files.
  224.  
  225. ---
  226.  * RagTag 0.03 *  If you can read this, thank Colin, Sparky, and Dan.
  227.